home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmlogmerge.z / pmlogmerge
Text File  |  1997-04-03  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLOOOOGGGGMMMMEEEERRRRGGGGEEEE((((1111))))                                                    PPPPMMMMLLLLOOOOGGGGMMMMEEEERRRRGGGGEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmllllooooggggmmmmeeeerrrrggggeeee - concatenate and merge Performance Co-Pilot archive logs
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmllllooooggggmmmmeeeerrrrggggeeee [----ssss _s_a_m_p_l_e_s] [----SSSS _t_i_m_e] [----TTTT _t_i_m_e] [----vvvv _v_o_l_s_a_m_p_l_e_s]
  13.      _i_n_p_u_t [...]  _o_u_t_p_u_t
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmllllooooggggmmmmeeeerrrrggggeeee operates upon archive logs of performance metric values that
  17.      may be ``played back'' by other Performance Co-Pilot (PCP) tools.  These
  18.      logs form the basis of the VCR paradigm and retrospective performance
  19.      analysis services common to the PCP toolkit.
  20.  
  21.      Like ccccaaaatttt(1), ppppmmmmllllooooggggmmmmeeeerrrrggggeeee accepts one or more PCP archives named via the
  22.      _i_n_p_u_t arguments, and produces a single PCP archive with _o_u_t_p_u_t as the
  23.      base name for the physical files that constitute an archive log.
  24.  
  25.      All of the _i_n_p_u_t archives must have been collected from the same host.
  26.  
  27.      Without any arguments, ppppmmmmllllooooggggmmmmeeeerrrrggggeeee uses the timestamps associated with
  28.      each record in an archive to merge all of _i_n_p_u_t archives into a single
  29.      _o_u_t_p_u_t archive with all records in their correct chronological sequence.
  30.      If the _i_n_p_u_t archives were created over disjoint time intervals, this
  31.      process is equivalent to concatenating the archives in the correct
  32.      temporal sequence.
  33.  
  34. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  35.      The command line options ----SSSS and ----TTTT control the overall start and end time
  36.      for the resultant merged archive, allowing one to clip the merge to a
  37.      window of time. These options are common to most Performance Co-Pilot
  38.      tools and are fully described in ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3).  The other time
  39.      window options, ----AAAA and ----OOOO, are not applicable in this context and are not
  40.      supported.
  41.  
  42.      The other available options are:
  43.  
  44.      ----ssss   Force the merge to terminate after _s_a_m_p_l_e_s log records have been
  45.           written. This will override the ----TTTT option if it occurs sooner.
  46.  
  47.      ----vvvv   The _o_u_t_p_u_t archive is potentially a multi-volume data set, and the
  48.           ----vvvv option causes ppppmmmmllllooooggggmmmmeeeerrrrggggeeee to start a new volume after _v_o_l_s_a_m_p_l_e_s
  49.           log records have been written to the archive.
  50.  
  51. FFFFIIIILLLLEEEESSSS
  52.      For each of the _i_n_p_u_t and _o_u_t_p_u_t archives, several physical files are
  53.      used.
  54.      _a_r_c_h_i_v_e....mmmmeeeettttaaaa        metadata (metric descriptions, instance domains,
  55.                          etc.) for the archive log
  56.      _a_r_c_h_i_v_e....0000           initial volume of metrics values (subsequent volumes
  57.                          have suffixes 1111, 2222, ...)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMLLLLOOOOGGGGMMMMEEEERRRRGGGGEEEE((((1111))))                                                    PPPPMMMMLLLLOOOOGGGGMMMMEEEERRRRGGGGEEEE((((1111))))
  71.  
  72.  
  73.  
  74.      _a_r_c_h_i_v_e....iiiinnnnddddeeeexxxx       temporal index to support rapid random access to the
  75.                          other files in the archive log
  76. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  77.      ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmllllcccc(1), ppppmmmmllllooooggggggggeeeerrrr(1), and PPPPMMMMAAAAPPPPIIII(3).
  78. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  79.      All error conditions detected by ppppmmmmllllooooggggmmmmeeeerrrrggggeeee are reported on _s_t_d_e_r_r with
  80.      textual (if sometimes terse) explanation.
  81.      Should one of the input archive logs be corrupted (this can happen if the
  82.      ppppmmmmllllooooggggggggeeeerrrr instance writing the log suddenly dies), then ppppmmmmllllooooggggmmmmeeeerrrrggggeeee will
  83.      detect and report the position of the corruption in the file, and any
  84.      subsequent information from that archive log will not be merged.
  85.      If any error is detected,
  86.      will exit with a non-zero status.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.